home *** CD-ROM | disk | FTP | other *** search
/ The Fatted Calf / The Fatted Calf.iso / Applications / Graphics / Gnuplot / INTRO next >
Encoding:
Text File  |  1993-03-18  |  4.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. Gnuplot NeXTSTEP Front End 1.1
  5. March 1993
  6.  
  7.  
  8.  
  9. Launching the NeXTSTEP App
  10. --------------------------
  11.     To launch the NeXTSTEP app, double click its icon in the
  12. Workspace File Viewer.  The app will launch and will create a blank,
  13. untitled plot.  To look at some of the sample documents, choose
  14. "Open..." from the Plot menu and select the sample plot(s) in the
  15. Samples folder.  (Alternatively, if you install the app in ~/Apps,
  16. /LocalApps, or your dock, you may double click the sample plot(s) in
  17. the Workspace File Viewer.  If the sample plots do not have the
  18. Gnuplot icon in the File Viewer, choose "Update Views" from the
  19. Workspace Views menu.)
  20.  
  21.  
  22. Running the Command Line Version
  23. --------------------------------
  24.     To run the command line version, go to a Terminal or Stuart
  25. window, cd to the directory containing the executable (probably
  26. ~/Apps/Gnuplot.app) and type "./Gnuplot -c [gnuplot options]".  Using
  27. -c as the first argument specifies that you want the command line
  28. version.  The standard Gnuplot banner and copyright information will
  29. be displayed, and you will get a "gnuplot>" prompt.
  30.  
  31.     If you have files of Gnuplot commands, you may load them into
  32. the command line version with "./Gnuplot -c filename".  You may also
  33. open them with the NeXTSTEP app if you give each filename a ".gnuplot"
  34. extension.  (Note that irrelevant commands, such as set terminal, set
  35. output, pause, and any commands after the first plot command, will be
  36. ignored, and you should use full path names when specifying external
  37. files.)
  38.  
  39.  
  40. What the NeXTSTEP Version Can't Do
  41. ----------------------------------
  42.     I initially wrote this app for myself, and I admit that the
  43. Gnuplot features that the app does not support are those that I rarely
  44. use.  At this point, most features are implemented to some degree but
  45. still need to be extended.  For example, you may now plot contours,
  46. but the NeXTSTEP interface does not support adjusting the number and
  47. spacing of contour lines.
  48.  
  49.     Adding such extensions would be fairly easy because they are
  50. supported by the underlying code, I just haven't added them to the
  51. interface yet.  If you are impatient, feel free to tweak Gnuplot
  52. documents with a text editor and then reopen them in Gnuplot, thus
  53. using the app as a Gnuplot previewer (it can preview features that it
  54. cannot directly manipulate).
  55.  
  56.     Some of the features that are not yet included are
  57.  
  58.     -- adequate support for parametric plots:  ranges and
  59.        reordering of functions within a pair/triple.
  60.  
  61.     -- positioning of titles and axis labels
  62.  
  63.     -- labels that can be placed at arbitrary locations and arrows
  64.        that can point to arbitrary locations (although I bet
  65.        anyone with an app like Diagram will never use these two
  66.        features)
  67.  
  68.     -- user-defined functions and variables
  69.     
  70.     -- extensive formats for user-defined tic marks
  71.  
  72.  
  73.     Additionally, I'd like a few more NeXTSTEP additions:
  74.  
  75.     -- Allow creation/editing of raw data points within Gnuplot,
  76.        with the option of saving the data to a text file, which
  77.        would allow the app to...
  78.  
  79.     -- ... provide a service that allows the user to select
  80.        columns of text in other apps (spreadsheets, word
  81.        processors) and plot them with Gnuplot
  82.  
  83.     -- Color support
  84.  
  85.     -- Better graphical depiction of pairs/triples of functions
  86.        for parametric plots in the Data Inspector
  87.  
  88.     -- Ability to drag data files onto the plot window instead of
  89.        onto the Gnuplot app icon.  It would make more sense and
  90.        would cause less conflict with dock-extenders like Engage.
  91.        I was just being lazy.
  92.  
  93.     -- Support NeXTSTEP 3 features, like interactive help, links,
  94.        etc.
  95.  
  96.  
  97. Acknowledgements
  98. ----------------
  99.     Although I worked on this alone, I examined and borrowed code
  100. and ideas from many sources:
  101.  
  102.     -- NeXTSTEP Examples and Mini-Examples, primarily
  103.        CellScrollView by R. Dunbar Poor and Mai Nguyen,
  104.        ScrollDoodScroll by Jayson Adams, and Draw by Paul Hegarty.
  105.        Any classes or methods that I used have their origins
  106.        documented in the code.
  107.  
  108.     -- Nick Strobel, whose Gnuplot terminal served as an example.
  109.        My custom terminal is similar to his first version -- it
  110.        creates a stream of PostScript which is used to create an
  111.        NXImage that is composited into the plot window.  His
  112.        second version is faster and less of a memory hog, but it
  113.        violates some "rules" about messaging Objective-C objects
  114.        from a .c file.  I'm trying to think of a clean, legal way
  115.        around this.  (By the way, Strobel's terminal is included
  116.        with the official Gnuplot 3.3 distribution and is,
  117.        therefore, included here if you'd like to try it.)
  118.  
  119.     -- Russell Lang, whose official Gnuplot PostScript terminal
  120.        driver is the basis for my custom terminal driver.  In fact,
  121.        mine is a very slight modification of his.
  122.  
  123.     -- Usenet's comp.sys.next.programmer.  The best source of cool
  124.        tips on the planet.
  125.  
  126.  
  127. Don't spill anything,
  128. Rob
  129.  
  130. davis@sonata.cc.purdue.edu
  131. 71302.273@compuserve.com
  132.  
  133.